Skip to content

Conversation

grmbyrn
Copy link
Collaborator

@grmbyrn grmbyrn commented Jul 10, 2025

Add blog post: Setting Up Torrust with Claude Code

This PR adds a new blog post documenting the full local development setup of the Torrust project using Claude Code as an AI assistant. The post walks through:

  • Project structure detection and environment analysis
  • Building and configuring the tracker, index, and GUI components
  • Debugging setup issues (missing DB files, port conflicts, CORS problems)
  • Final setup instructions and service orchestration

The content is based on a real session and aims to help others replicate a clean, working environment from scratch. Also includes structured headings, a ToC, and styled code blocks for clarity.

@grmbyrn grmbyrn requested a review from josecelano July 10, 2025 21:30
@josecelano josecelano self-assigned this Oct 20, 2025
Copy link
Member

@josecelano josecelano left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi @grmbyrn, sorry for the delay.

  1. Empty sections

I would merge the three headings:

  • Setting Up Torrust with Claude Code
  • Initial Setup and Analysis
  • What Claude Code Did Right

into one to avoid having empty sections.

  1. Escaped chars

There are some escaped chars in a code block, and they should not.

Image
  1. Next

I think we could create a new repo (https://github.com/torrust/torrust-dev-setup/) to:

  • Provide a bash script to install the dev env for the whole solution (Tracker+Index)
  • Provide instructions to use the repo (optimised for AI agents)
  • Provide a troubleshooting guide for issues related to installation and connect all services (for problems specific to one service, we should redirect to the corresponding repo).

Then we can try again to install the services using the new repo and update the article.

In summary, I think we should remove the friction to set up the dev env.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants